home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / ACORNUSERS / EMULATOR / MGEAR / !MGear / MG.doc < prev    next >
Text File  |  1998-08-18  |  9KB  |  209 lines
  1.                          ******* MasterGear *******
  2.            The Portable SEGA Mark3/MasterSystem/GameGear Emulator 
  3.                           version 1.1 (08/17/1998)
  4.  
  5.                              by Marat Fayzullin
  6.  
  7.                       WWW: http://www.komkon.org/fms/
  8.  
  9.  
  10.  
  11.  
  12.                                * DICLAIMERS *
  13.  
  14. * MasterSystem and GameGear are registered trademarks of SEGA.
  15. * The author is in no way affiliated with SEGA.
  16. * The author is in no way affiliated with any pirate group out there.
  17. * The author can not provide you with MasterSystem/GameGear games.
  18.  
  19.  
  20.  
  21.                          * NEW IN THIS VERSION *
  22.  
  23. * Windows version is now ready and available for sale. You can
  24.   register it online with a credit card. 
  25. * VPeriod/HPeriod are counted in the CPU cycles instead of CPU
  26.   opcodes.
  27. * Fixed bug preventing RainbowIslands from running.
  28. * Fixed bug which caused trash to appear on display in GalaxyForce.
  29. * Changed VRAM read/write code which fixed glitches in SurfingNinjas
  30.   and many other games using inappropriate VRAM access modes.
  31. * Changed -delay option so that AstroWarrior, MahJong, and several
  32.   other games run without glitches.
  33. * Changed sound chip base frequency to make it sound correctly.
  34. * Changed keyboard assignments (see documentation). 
  35. * Unix version runs in 8bpp, 16bpp, 32bpp, and 24bpp X11 modes
  36.   (24bpp not on all servers though).
  37. * Music is saved in the MIDI format. No conversion needed.
  38.  
  39.  
  40.  
  41.                             * INTRODUCTION *
  42.  
  43.   MasterGear is a portable emulator of two SEGA game consoles: the
  44. MasterSystem (known as Mark3 in Japan) and the portable GameGear which is
  45. basically an improved MasterSystem in a smaller package. The emulator is
  46. written in C and therefore can be ported to any computer platform out
  47. there, given that this platform can run 32-bit applications. You can
  48. always get the latest MasterGear binaries and support files from
  49.  
  50.                     http://www.komkon.org/fms/MG/
  51.  
  52.   At this moment, MG is able to run about 95% of the SMS/GG carts I have,
  53. although the emulation is still far from perfection. With the help from
  54. friends I hope to make it as close to original machines as possible. 
  55.  
  56.   If you have any information on the MasterSystem/GameGear, or the
  57. ROM-images which can be used for testing, and are willing to help, feel
  58. free to send me email. Any *intelligent* help is greatly appreciated :).
  59.  
  60.   Following games have problems when running on MG:
  61.  
  62.   Dynamite Headdy GG   - Screen sometimes blinks. Use higher -vperiod.
  63.   Terminator 3 GG      - Status line doesn't show up.
  64.   GP Rider GG          - The road sometimes gets distorted.
  65.  
  66.   Following games have problems when run without -delay:
  67.  
  68.   Mahjong GG           - Distorted screen.
  69.   Astro Warrior SMS    - Remains of blown cannons are distorted.
  70.   Aerial Assault GG    - SEGA logo misses "TM" sign.
  71.  
  72.   If you find a cause of any bugs mentioned above, or know of any other
  73. game having problems, send me email.
  74.  
  75.  
  76.  
  77.                              * BUTTONS *
  78.  
  79.   MasterGear is controlled by following buttons:
  80.  
  81.   [SPACE]    - FIRE-A button (also: [LALT],A,S,D,F,G,H,J,K,L)
  82.   [LCONTROL] - FIRE-B button (also: Z,X,C,V,B,N,M)
  83.   [ENTER]    - START button (only in GameGear mode)
  84.   [TAB]      - RESET button (only in MasterSystem mode)
  85.   [BACKSPC]  - PAUSE button (only in MasterSystem mode)
  86.   [ESC]      - Quit emulation (also: [F12])
  87.   [F11]      - Reset SMS or GameGear
  88.   [F2]       - Turn soundtrack log on/off
  89.   [F3]       - Toggle FIRE-A autofire on/off
  90.   [F4]       - Toggle FIRE-B autofire on/off
  91.  
  92.   [SHIFT] and [CAPSLOCK] switch between MasterSystem joypads
  93.  
  94.   When compiled with -DSOUND:
  95.   [1]-[4]    - Toggle sound channels on/off
  96.   [0]        - Toggle all sound on/off
  97.   [-]        - Decrease sound volume
  98.   [+]        - Increase sound volume
  99.  
  100.   When compiled with -DDEBUG:
  101.   [F1]       - Go into built-in debugger
  102.  
  103.   When compiled with -DMSDOS:
  104.   [F8]       - Toggle joystick 1 on/off
  105.   [F9]       - Toggle joystick 2 on/off
  106.   [F10]      - Make a screen snapshot (SNAPxxxx.GIF)
  107.  
  108.  
  109.  
  110.                       * COMMAND LINE OPTIONS *
  111.  
  112.   MasterGear can be started with options described below. Be aware that
  113. not all of these options may be present in your particular version of MG. 
  114. Do "mg -help" for the list of options in your version. 
  115.  
  116.   -verbose <level>    - Select debugging messages [5]
  117.                          0 - Silent             1 - Startup messages
  118.                          2 - Illegal accesses   4 - Illegal Z80 ops
  119.                          8 - Bank switching    16 - Sound
  120.                         32 - VDP registers     64 - VRAM accesses
  121.   -hperiod <period>   - Number of CPU cycles per HBlank [215]
  122.   -vperiod <period>   - Number of CPU cycles per VBlank [65000]
  123.   -uperiod <period>   - Number of VBlanks per screen update [3]
  124.   -help               - Print this help page
  125.   -sms/-gg            - Run in MasterSystem/GameGear mode [-sms]
  126.                         (overrides .SMS/.GG file extensions)
  127.   -engl/-jap          - Run in English/Japanese mode [-engl]
  128.                         (overrides country code in GG carts)
  129.   -autoa/-noautoa     - Autofire/No autofire for button A [-noautoa]
  130.   -autob/-noautob     - Autofire/No autofire for button B [-noautob]
  131.   -delay/-nodelay     - Delay/Don't delay VRAM reads [-nodelay]
  132.   -logsnd <filename>  - Write soundtrack to a MIDI file [LOG.MID]
  133.   -sound [<quality>]  - Sound emulation quality [0]
  134.                         0 - Off                1 - Adlib (MSDOS)
  135.                         Values >8191 are treated as wave synthesis
  136.                         frequencies. Default frequency is 22kHz.
  137.   -nosound            - Don't emulate sound [-nosound]
  138.   -back <filename>    - Use <filename> as background picture [MG.GIF]
  139.   -vsync/-novsync     - Sync/Don't sync screen updates [-novsync]
  140.  
  141.  
  142.  
  143.                              * NOTES *
  144.  
  145.   SEGA MasterSystem and GameGear are both nice little machines, logically
  146. structured and much less weird than Nintendo hardware. The CPU used is
  147. Z80, the original one, with no custom changes. Video controller seems to
  148. be based on a well known TMS9918/9928 (MSX,Coleco,TI99/4), but has only
  149. one screenmode (as far as I know), and is thoroughfully mutated in some
  150. other aspects. There is no BIOS ROM as in MSX or ColecoVision.
  151.  
  152.   MasterGear comes without any ROM images due to copyright reasons. 
  153. Please, *do not* send me mail asking for ROM images: I can not give you
  154. any, no matter how strongly you desire to get them.
  155.  
  156.   MasterGear works with "raw" ROM images, and therefore the default file
  157. extension is .ROM. It may be a wise idea to use .SMS and .GG extensions
  158. to distinguish between MasterSystem and GameGear ROMs though. Since
  159. version 0.6, MasterGear checks the file extension and forces emulation
  160. into MasterSystem or GameGear mode if extension is .SMS or .GG. In the
  161. GameGear mode, the country code is also checked. If the cartridge is
  162. either for Japan or for US/Europe only, and there was no localization
  163. option given, the localization switch is forced into an appropriate state.
  164.  
  165.   Some copiers add a 512-byte header to the ROM image files they create. 
  166. If you see a ROM image whose size is a multiple of 16384 bytes + 512,
  167. simply cut off the first 512 bytes to et the raw image. Unix users can do 
  168. it in a following way:
  169.  
  170.             dd if=<input-file> of=<output-file> skip=1 bs=512
  171.  
  172.   When compiled with ZLIB option, MasterGear will be able to transparently
  173. handle files packed with GZIP and ZIP, which helps to save the disk space.
  174. You will need the ZLib library by Jean-loup Gailly and Mark Adler though.
  175. Its source is freely available on the Net.
  176.  
  177.   The MSDOS version can be compiled with GIFLIB option. Then, it will
  178. allow you to load backdrop pictures from the .GIF files, and save screen
  179. snapshots into .GIF files. You will need the GIFLib library by Gershon
  180. Elber, available from SimTel and other archives. 
  181.  
  182.   That's it. Have fun!
  183.  
  184.  
  185.  
  186.                                * THANKS *
  187.  
  188.   I would like to thank Richard Aplin, Chris Shay, Neil Harding, who
  189. helped with invaluable technical information about MasterSystem and
  190. GameGear. Thanks also go to (alphabetically)
  191.  
  192. * Gershon Elber, author of GIFLib.
  193. * Marcel de Kogel, who helped me with the MSDOS port.
  194. * Alex Krasivsky, the initial author of Adlib sound driver on
  195.   which MG-DOS sound is based.
  196. * Juan Luis Lario for the pictures of GameGear.
  197. * James McKay, author of 'Massage'.
  198. * Authors of ZLib and Markus Oberhumer, who told me about ZLib.
  199. * Charles Scheffold and other authors of PMODE/W.
  200. * Ian Spielman, who wrote the enchanced Unix/X drivers for MG.
  201. * John Stiles, author of the MG port to Macintosh.
  202. * Unknown guy from .BR who showed me how to handle PC joystick.
  203. * Many other people who helped with information, bug reports,
  204.   and cart images for testing.
  205.  
  206.  
  207. -----------------------------------------------------------------------------
  208. Marat Fayzullin (fms@cs.umd.edu)
  209.